OpenEdge Development:<br />Progress 4GL Reference FRAME-FILE function

Release 10.1A: OpenEdge Development:
Progress 4GL Reference

FRAME-FILE function

Returns the name of the database table that contains the field the cursor is in. The FRAME-FILE function is useful if you want to provide users with context-sensitive help.
Note: Does not apply to SpeedScript programming.

Syntax
FRAME-FILE 
Example

This procedure updates fields from the order table and the customer table. It uses the FRAME-FILE function to tell you which table contains the field being updated.
r-frfile.p
FOR EACH customer, EACH order OF customer:
      DISPLAY order-num WITH CENTERED ROW 2 FRAME onum.
      UPDATE
        customer.cust-num AT 5 order.cust-num AT 30 SKIP
        customer.name  AT 5
        customer.city AT 5
        customer.state AT 5
        customer.postal-code AT 5
        WITH ROW 8 CENTERED 1 DOWN NO-LABELS
        EDITING:
         MESSAGE "     The field" FRAME-FIELD "is from the" FRAME-FILE
                 "file     ".
         READKEY.
         APPLY LASTKEY.
      END.  /* Editing */
END. 
Notes

FRAME-FILE returns a null string if the frame field being entered is not associated with a database field.

If the cursor is not in an enabled input field when the last input statement ends, FRAME-FILE returns a null string.

The FRAME-FILE value is set to blanks at the next PAUSE statement, at the next READKEY statement, or when Progress pauses automatically.

See also

FRAME-FIELD function, FRAME-VALUE function, PROGRAM-NAME function